home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 2003 August / MW 8 2003 CD1.iso / Inside Macworld / Product News / gimp-1.2.4.sit / gimp-1.2.4 / devel-docs / gih.txt < prev    next >
Encoding:
Text File  |  2000-12-18  |  1.6 KB  |  52 lines
  1. Gimp Image Pipe Format
  2.  
  3. The gih format is use to store a series of brushes, and some extra info 
  4. for how to use them. 
  5.  
  6. Basically, the format is real simple. It is a text header, followed
  7. by a series of gbr files, all concatenated together.
  8.  
  9. An image pipe can be thought of as an n-dimensional array of brushes.  
  10. Each dimension is indexed when the pipe is used in painting by some 
  11. parameter, eg an incremental counter, a random value, pointing device 
  12. pen pressure,tilt or velocity , etc.
  13.  
  14. An idea for how to implement editing of image pipes (with the GIMP) is
  15. that each layer of the edited image representing the pipe is divided
  16. conceptually (and visualized by guides) into equal-sized elements,
  17. each element containing one pixmap brush. The typical cases are only
  18. one layer, with an array of brushes, or many layers, with just one
  19. brush per layer. (For instance something produced by some animator.)
  20.  
  21. The header format
  22. ================
  23.  
  24. First line is the name of the pipe.
  25. Second line is the number of brushes in file, followed by the contents of
  26. the gimp-image-pipe-parameters parasite (a text string)
  27.  
  28. ie
  29. ===========================
  30. Fire
  31. 6 ncells:6 step:20 dim:1 cols:3 rows:2 rank0:6 selection:incremental
  32. ===========================
  33.  
  34. The rest is just gbr files catted in.
  35.  
  36. Making a gih file:
  37.  
  38.     1. Create a series of gbr files. Note these do not
  39.     need to be the same size.
  40.  
  41.     2. Create a text header like above.
  42.  
  43.     3. Combine them all together:
  44.  
  45.         cat header brush1.gbr brush2.gbr brush3.gbr > foo.gih
  46.  
  47.  
  48. Or use the GIH plug-in to save a brush pipe from an image.
  49.  
  50.  
  51. Thats about it for now.
  52.